home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1997 August / Macworld (1997-08).dmg / Shareware World / Info / For Developers / InstallerMaker™ 4.0 Installer / Customizing InstallerMaker / Editing IM Resources / Editing Installer Resources < prev    next >
Text File  |  1997-05-10  |  4KB  |  93 lines
  1. How to Edit Your Installer's Resources
  2. © Copyright 1997 d Aladdin Systems, Inc.
  3. -------------------------------------
  4.  
  5. All of the user interface elements your users see when they run an 
  6. InstallerMaker product installer can be changed if you need to do
  7. so. Many of these items can be changed directly from within the
  8. InstallerMaker application you use to configure your product
  9. installers.
  10.  
  11. Occasionally, you will not see the string you want to change, or
  12. you will need to change the size of a dialog, or the location of
  13. items within a dialog.  These can also be changed, through the
  14. use of a resource editing application like ResEdit (available
  15. from Apple) or Resorcerer (from Mathemaesthetics, Inc.).  This document
  16. describes how to use a resource editor to change the user 
  17. interface elements you want to change.
  18.  
  19. For the rest of this document, we assume that you own a resource 
  20. editor, and that you know how to use it.  If the topic of
  21. resource editing on a Macintosh is new to you, we recommend 
  22. "Zen and The Art of Resource Editing", a book available from the
  23. Berkeley Macintosh Users Group (BMUG).  You can reach BMUG by
  24. telephone at 510-549-2684, or via the Web at www.bmug.org. The
  25. old style address is:
  26.  
  27.  BMUG Inc. 
  28.  1442A Walnut Street, #62 
  29.  Berkeley, CA 94709-1496
  30.  
  31.  
  32. How To Edit a Resource In Your Installer
  33. ----------------------------------------
  34.  
  35. Since our installers use resource compression, most resources in
  36. your product installer are compressed, and can not be edited 
  37. directly. To find an uncompressed copy of an installer's resources,
  38. you should locate the file "English to Localize" located in the 
  39. "languages" folder found in the same folder as the InstallerMaker 3.0
  40. application.  The steps to change a resource are:
  41.  
  42. 1) Open the " English to Localize" file in your resource editor 
  43. and locate the resources that you want to change.
  44.  
  45. 2) Create a new resource file in your resource editor, and copy
  46. _only_ the resources you want to change into the new resource
  47. file.
  48.  
  49. 3) Use your resource editor to modify your resources, and save the
  50. changes.
  51.  
  52. 4) Open your installer archive up in InstallerMaker 3.0, and note the
  53. icon on the lower left of the window.  This is a button used to link
  54. an "included resources" file to your archive.  If it says "No resource
  55. file included", then you are not currently including a resource file.
  56. If this is the case, click on the icon, and select your resource file
  57. you created in step (2) in the file selection dialog that comes up.
  58.  
  59. If you've already selected some other file, perhaps because you've
  60. included InstallerMaker extensions into your installer, you'll need
  61. to copy the resources in your new file into the file that contains your
  62. custom resources.  The procedure is the same as the one you used in
  63. step (2).
  64.  
  65. 5) Build your installer as usual.  InstallerMaker will build your
  66. modified resources into your product installer, giving you the affect
  67. you wanted.
  68.  
  69.  
  70. Warnings About Changing Resources
  71. ---------------------------------
  72.  
  73. Remember that when you change a resource your product installer uses,
  74. you are changing the data the product installer uses to display information
  75. to your users.  As a rule of thumb, changing the wording of any item is
  76. perfectly safe, and changing one picture with a different picture will
  77. also be safe.  In addition, changing the size of a DLOG or ALRT resource
  78. is OK, as is changing the position of an item in a dialog list resource
  79. (DITL).
  80.  
  81. Two things, however, are not safe.  You should never delete an item
  82. in a DITL, nor should you insert new items into a DITL in such a way that
  83. the item numbers of standard items change.  Doing this will cause your
  84. installers to behave strangely, or even crash. 
  85.  
  86.  
  87. Changing the Progress Dialog
  88. -----------------------------
  89.  
  90. You can also modify the progress dialog that comes up during the unstuffing
  91. process. If you need to do this, read the document "Customizing Progress Bars"
  92. in the same folder as this document.
  93.